home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / comm / sbn32_33.zip / NEWSBOT.DOC < prev    next >
Text File  |  1996-06-20  |  32KB  |  635 lines
  1. SBNews: News Robot Utility 
  2.  
  3. (C) Scott M Baker 
  4.  
  5. -------------------------------------------------------------------------------
  6.  
  7. Note: This program is still in the early beta stages. It hasn't been very 
  8. extensively tested and it's very possible that you may experience trouble. 
  9. Please report any problems to me at smbaker@primenet.com.
  10.  
  11. I variously refer to this program under the names "NewsBot" and "SBNews" 
  12. throughout the document. You can for the most part consider them to be the 
  13. same. Eventually, I plan on including extra utilities in this package, "SBNews" 
  14. will be the name of the full package and "NewsBot" will be the name of the News 
  15. Robot utility within the package.
  16.  
  17. -------------------------------------------------------------------------------
  18.  
  19. Table of Contents 
  20.  
  21.     * Purpose
  22.     * General Information
  23.           * System Requirements
  24.           * Distribution Information
  25.           * Features
  26.           * Files Included
  27.     * Installation
  28.     * Command Line Parameters
  29.     * JPEG Viewer
  30.     * Configuration
  31.     * Statistics
  32.     * Unfinished Stuff/Planned Enhancements
  33.     * Acknowledgements
  34.     * Registration
  35.     * How to Contact the Author
  36.     * Revision History
  37.  
  38. -------------------------------------------------------------------------------
  39.  
  40. Purpose: 
  41.  
  42. The purpose of this program is to automatically download and uudecode files 
  43. from newsgroups via a winsock connection. If you've found this program, then 
  44. you probably know what this means, so I won't go into detail. Newsbot will 
  45. attempt to piece together multi-part files. 
  46.  
  47. If you're new to binary newsgroups, then here are a few G-rated newsgroups that 
  48. you might wish to try: 
  49.  
  50. alt.binaries.pictures.astro
  51. alt.binaries.pictures.animals
  52. alt.binaries.pictures.cartoons
  53. alt.binaries.pictures.fractals
  54.  
  55. There are a wealth of adult-oriented newsgroups, but I'm not going to list them 
  56. in this document. 
  57.  
  58. I have included a sample file, SAMPLE_G.TXT, which includes a listing of binary 
  59. newsgroups. There are no descriptions, but you can probably find out from the 
  60. newsgroup name what subject matter the newsgroup deals with. 
  61.  
  62. -------------------------------------------------------------------------------
  63.  
  64. Requirements: 
  65.  
  66.     * Windows 3.1 or greater 
  67.     * Winsock connection capability (i.e. SLIP or PPP) 
  68.  
  69. Distribution: 
  70.  
  71.     * 16-bit (Windows 3.1) Version: SBNEWSxx.ZIP (xx denotes version number)
  72.     * 32-bit (Windows 95) Version: SBN32_xx.ZIP (xx denotes version number
  73.  
  74. Features:
  75.  
  76.     * Unattended download - do other work (or go out to lunch) while downloads 
  77.       and uudecoding are all processed for you! 
  78.     * Automatic HTTP address logging -- NewsBot will keep track of any HTTP 
  79.       URL's that were found while downloading addresses. These will be saved to 
  80.       a convenient HTM file, HTTPGRAB.HTM. 
  81.     * Built in JPEG viewer. Allows you to see postage-stamp size images of the 
  82.       files you are downloading in progress. 
  83.     * Delete/View previously downloaded JPEG files. 
  84.     * Comprehensive logging capabilities - save the subject and from 
  85.       information for files that you might want to follow up on later. 
  86.     * Dupe Checkers -- avoid downloading the same files multiple times. 
  87.  
  88. Files Included: 
  89.  
  90.     * NEWSBOT.EXE: Executable; what you need to run to get the program to work. 
  91.     * NEWSBOT.HTM: Documentation in HTML format (read with your browser) 
  92.     * NEWSBOT.DOC: Documentation in plain-ASCII format (read with any plain 
  93.       ascii text editor) 
  94.     * BWCC.DLL (16-bit) or BWCC32.DLL (32-bit): Borlands Custom-Control DLL 
  95.       library; used to support Newsbot's grey dialog boxes. 
  96.     * FILE_ID.DIZ: Brief description file; useful for bbs distribution 
  97.     * SAMPLE_G.TXT: Plain-ASCII listing of binary newsgroups 
  98.     * REGISTER.HTM: Registration info in HTML format 
  99.     * REGISTER.DOC: Registration info in plain-ASCII format 
  100.     * README.1ST: General information on documentation & archives 
  101.  
  102. -------------------------------------------------------------------------------
  103.  
  104. Installing and Using the Program: 
  105.  
  106. Here are some very quick notes on installing and using Newsbot: 
  107.  
  108. Installation: 
  109.  
  110.    1. Unzip the distribution archive into the directory of your choice. 
  111.  
  112. Running: 
  113.  
  114.    1. Run NEWSBOT.EXE -- this can be done in various ways - from the Win-95 
  115.       command prompt, the Windows Explorer (and/or file manager), the Windows 
  116.       Run Program command, etc. 
  117.    2. On your first session, you'll be prompted for a "News Host Name". This is 
  118.       the name of your news host, and should be given to you by your ISP 
  119.       (internet service provider). 
  120.    3. On your first session, you'll be prompted for a "download path". This is 
  121.       the path where you want the files you download to be placed. 
  122.    4. Once NewsBot is loaded, you'll want to add some newsgroups. This is done 
  123.       with the "Add" button. You'll need to know the names of the groups you 
  124.       want; you might want to consult SAMPLE_G.TXT for some sample newsgroup 
  125.       names. 
  126.    5. Press the "CONNECT" button to start everything. All else should be mostly 
  127.       automatic from here on. Feel free to tinker around with the menu items 
  128.  
  129. -------------------------------------------------------------------------------
  130.  
  131. Command Line Parameters
  132.  
  133.     * "-i INI_FILE_NAME". Sets the name of the INI file to use. By default, 
  134.       newsbot uses the file newsbot.ini in your windows directory. Specifying a 
  135.       filename here will cause newsbot to use the file under that name in 
  136.       newsbot's home directory. For example "Newsbot -i news1.ini" would use 
  137.       the filename "news1.ini" in newsbot's home directory. 
  138.     * "-auto". Will automatically begin downloading news articles as soon as 
  139.       newsbot has loaded. Note: For unregistered users, about screen will still 
  140.       be displayed!
  141.     * "-noabout". Omits display of the about dialog on startup of Newsbot. 
  142.       Note: Only supported in registered version!
  143.  
  144. -------------------------------------------------------------------------------
  145.  
  146. Jpeg Viewer
  147.  
  148. SBNews has a built in Jpeg viewer for viewing JPEG files offline. The JPEG 
  149. viewer can be operated in several ways: 
  150.  
  151.    1. By double-clicking on a [RECEIVED] entry in Newsbot's log window 
  152.    2. By single-clicking on one of the preview pictures on the right hand side 
  153.       of Newsbot's main window. 
  154.    3. By using the FILE:VIEW JPEG option from Newsbot's pulldown menu. 
  155.  
  156. Once loaded, the JPEG viewer window will display the JPG file selected and 
  157. include a listing of filenames and directories on the left-hand side of the 
  158. window. This listing is provided to let you easilly select other files to view. 
  159. Double clicking on a directory in the directory list will change to that 
  160. directory and double clicking on a filename in the file list will display that 
  161. file. The CHDIR and VIEW buttons perform the same functions, respectively. 
  162.  
  163. The "<" and ">" buttons will view the immediately previous and next files in 
  164. the currently selected directory. You may use these to rapidly view a list of 
  165. files that were downloaded overnight for example. The ">" button will activate 
  166. a slideshow of the current directory. Each file will be displayed, there will 
  167. be a slight delay, and the next file will be displayed. 
  168.  
  169. The FILE menu of the viewer has several options: 
  170.  
  171.     * Open File: Allows you to open a new file using the windows common-dialog 
  172.       open method. 
  173.     * Delete File: Deletes the current file that you are viewing. 
  174.     * Save as BMP: Saves the current image as a BMP image, which may later be 
  175.       used as windows wallpaper, for example. 
  176.     * Set as Wallpaper: Saves the current file as a BMP and tells window to use 
  177.       it was wallpaper. 
  178.  
  179. The SlideShow menu has a few options as well: 
  180.  
  181.     * Start/Stop: Starts and stops the slideshow, equivalent to the ">" button. 
  182.     * Set Interval: Sets the amount of delay between slideshow pictures. 
  183.     * "Normal Mode": Images will be displayed in the jpeg viewers window. 
  184.     * "Wallpaper Mode": Images wi